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The facility discussed in this publication is available on the IBM S/390 Parallel Enterprise Server The information published herein 
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Notices 


References in this publication to IBM producie, 
programs, or services de not amply that IBM 
intends to make these available in all countries in 
which IBM operates. Any reference to an IBM 
product is not intended to state or imply that only 
IBM's product may be used. Any functionally 
equivalent product may be used; however, this 
does not constituie a waiver in any way of iBM's 
inivileciuai properly nghis. 

IBM may have patents or pending patent anplica- 
tions covering subject matter described herein. 
Fumishing this publication docs not constitute or 
imply a grant of any license under any patents, 
patent applications, trademarks, copyrights, or 
other fights of IBM or of any third party, or any 
figit io refer io IBM m any advertising or other 
promotional or marketing aciivifies. iBM assumes 
no responsibility for any infringement of patents or 
other rights that may result from the use of this 
publication or from the manufacture, use, lease, or 
sale of apparatus described herein. 


Ba FEE OP 


Licenses under IBM's ulilily palents are available 
on reasonable and nondiscamimateory terms and 
conditions. Inquiries relative fo kcensing should 
be directed, in writing, to: 


international Business Machines Corporation 
IBM Director of Licensing 

500 Columbus Avenue 

Thornwood, New York 10594 

U.S.A. 


Trademarks 


The following terrns used in this publication are 
trademarks of the International Business Machines 
Corporation in the United States or other coun- 
tries: 


Enterprise Systems Architecture/390 
FSA/390 

IBM 

$/390 Paralle! Enterprise Server 
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Preface 


This publication describes the COMPARE AND 
SWAP AND PURGE instruction, also known as 
the broadcasted-purging facility, of the Enterprise 
Systems Architecture/290 (ESA/390) ! 


This publication ic informal and not orderable 
through PUBORDER. The publication contains 
information that will be placed in the next version, 


1 Enterprise Systems Architecture/390 and FSA/390 
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version -07, of Enterprise 
Archtectures390 = Principles oof 
SA22-7201, 


Systems 


Operatron, 


Terms and concepts referred to in this publication 
but explained in the aforementioned publication 
are not explained again in this publication. 


390 are trademarks of the International Business Machines Carporation. 
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COMPARE AND SWAP AND PURGE Instruction 


| 
Name |monic| 


COMPARE AND SWAP AND PURGE 


0 
Characteristics C 


fexelanatten: 
| $ Causes serialization. 
| A! Access exceptions; 
details. 
| C Condition code is set. 
| P Privileged-operation exception. 
R PER general-register-alteration event. 
K2 
| RRE RRE instruction format. 
SP Specification exception. 
| ST =6PER storage-aiteration event. 
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Figure 7. Summary of Control lostructions 


COMPARE AND SWAP AND 
PURGE 


bey first and second operands are compared. H 
4y are equal, the contents of genera! register 
A: + 1 are stored at the eye ern location, 
and a purging operation is performed. If they are 
mbites the second operand is loaded into the 
firgt-operand location. The r f the compar- 
ison is indicated in the condition code. 
Bits 16-23 of the instruction are ignored. 
The first operand is the contents of general rea- 
ister A:. The second operand is a wee in 
storage. The location of the leftmost byte of the 
second operand is designated by the cones of 
general register Ro. 


The purging operation applies to eee 
buffers (Al Bs} and transiation-lookaside buffe: 
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not all access exceptions may occur; see instruction description for 


Kz fieid designates an access register in the access-register mode. 


(TLBs) in all CPUs in the configuration. Either 
AlBs or TLBs, or both ALBs and ers may be 
selected for purging. All entries are cleared from 


the selected buffers 


The purging operation is sini by means of 
oe 30 and 31 of general register Rz. When bi 
36 is one, entries are Geared irom ALU 
bit 31 is one, entries are cieared from TLBs. 

n bite 30 and 31 both are ones, entries are 
cieared irom areas ang TL8s. When bits 30 and 


1 Lt. 
31 bon are zeros, no entries are cieared. 
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dicta of the address in general register Rz 
ig dependent on the addressing mode. In the 
24-bit saaaaiee mode, the contents of bit eo 
ions 8-29 of general register Rz, with two z 
appended on the right, constitute the address, sa 
ihe contents of bit positions 0-7 are ignored. in 
the 31-bit addressing mode, the contents of bit 
positions 

Zzefos appended on the fight, consiituie the 
address, and ite conieris of bili postition G are 
ignored. 
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The contents of the registers just described are 
shown in Figure 2 ori page 2. 
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24-Bit Addressing Mode 
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Figure 2. Register Contents for COMPARF AND 
SWAP AND PURGE 


When an equai comparison occurs, the contenis 
of general register Hi + 1 are stored at the 
second-operand focation. The fetch of the second 
operand for purposes of comparison and the store 
into the second-operand location appear to be a 
block-concurrent interlocked-update reference as 
observed by other CPUs. 


When ihe result of ihe comparison is unequai, ihe 
second-onerand loratinon ramaine unchanned 
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However, on some models, the value may be 
fetched and subsequently stored back unchang 
at the second-onerand location. This update 
appears to bc a biock-concurrent interlocked- 
update relerence as ouserved oy ciher CPUs. 

A seriaiizaition funciion is periormed before ithe 
operand is fetched and again after the operation is 
completed. 


When an equal comparison occurs, this CPU 
clears entries from ite ALB and TLB, as specified 
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by bie 20 and 21 of general register Az, and 
signais all CPUs in the conliguration to clear 

Saine specified enivies from their ALBs and TLBs. 
ine ALB enifies thai are cieared are aii ALB 
access-list designations, access-list eniries, 


ASW-second-tabie entries, and authority-tabie 
entries. {he {LB entries that are cleared are ail 
LB segment-tabie entries and page-table entries. 


The execution of COMPARE AND SWAP AND 
PURGE is not completed on the CPU which exe- 
cutes it until (1) all specified entries have been 
cleared from the ALB and TLB on this CPU and 
(2) all other CPUs in the configuration have com- 
pleted any storage accesses, including the 
updating of the change and reference bits, by 
using the specified ALB and TLR entries. 
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Resulting Condition Code: 


0 First and second operands equal, second 
operand replaced by contents of general reg- 
ister Ri + 7 

rirsi and sécond operands unequai, first 
operand repiaced Dy second operand 
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Program Exceptions: 


« Access (feich and sicre, operand 2} 
+ Priviiséged operation 
¢ 


Programming Note: COMPARE AND SWAP 
AND PURGE provides a broadcast form of the 


PURGE ALB and PURGE TLB instructions, thus 
mabkinn it possible in avoid uses of SIGNA! 
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